package com.tfswue.lhj.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.tfswue.lhj.common.PageQuery;
import com.tfswue.lhj.dto.UserDTO;
import com.tfswue.lhj.entity.User;
import com.tfswue.lhj.vo.UserVO;

import java.util.List;

/**
 * 用户服务接口
 * 
 * @author daygods
 * @since 2025-07-09
 */
public interface UserService extends IService<User> {
    
    /**
     * 用户注册
     * 
     * @param userDTO 用户注册信息
     * @return 注册结果
     */
    boolean register(UserDTO userDTO);
    
    /**
     * 用户登录
     * 
     * @param username 用户名
     * @param password 密码
     * @param loginIp 登录IP
     * @return 用户信息
     */
    UserVO login(String username, String password, String loginIp);
    
    /**
     * 根据用户名查询用户
     * 
     * @param username 用户名
     * @return 用户信息
     */
    User findByUsername(String username);
    
    /**
     * 根据邮箱查询用户
     * 
     * @param email 邮箱
     * @return 用户信息
     */
    User findByEmail(String email);
    
    /**
     * 分页查询用户列表
     * 
     * @param pageQuery 分页查询参数
     * @return 用户分页列表
     */
    IPage<UserVO> getUserPage(PageQuery pageQuery);
    
    /**
     * 根据ID获取用户详情
     * 
     * @param userId 用户ID
     * @return 用户详情
     */
    UserVO getUserById(Long userId);
    
    /**
     * 创建用户
     * 
     * @param userDTO 用户信息
     * @return 创建结果
     */
    boolean createUser(UserDTO userDTO);
    
    /**
     * 更新用户信息
     * 
     * @param userId 用户ID
     * @param userDTO 用户信息
     * @return 更新结果
     */
    boolean updateUser(Long userId, UserDTO userDTO);
    
    /**
     * 删除用户
     * 
     * @param userId 用户ID
     * @return 删除结果
     */
    boolean deleteUser(Long userId);
    
    /**
     * 更新用户状态
     * 
     * @param userId 用户ID
     * @param status 状态
     * @return 更新结果
     */
    boolean updateUserStatus(Long userId, Integer status);
    
    /**
     * 重置用户密码
     * 
     * @param userId 用户ID
     * @param newPassword 新密码
     * @return 重置结果
     */
    boolean resetPassword(Long userId, String newPassword);
    
    /**
     * 修改用户密码
     * 
     * @param userId 用户ID
     * @param oldPassword 旧密码
     * @param newPassword 新密码
     * @return 修改结果
     */
    boolean changePassword(Long userId, String oldPassword, String newPassword);
    
    /**
     * 检查用户名是否存在
     * 
     * @param username 用户名
     * @return 是否存在
     */
    boolean existsUsername(String username);
    
    /**
     * 检查邮箱是否存在
     * 
     * @param email 邮箱
     * @return 是否存在
     */
    boolean existsEmail(String email);
    
    /**
     * 获取最近登录的用户列表
     * 
     * @param limit 限制数量
     * @return 用户列表
     */
    List<UserVO> getRecentLoginUsers(int limit);
}